home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / protracker / pt.readme! < prev    next >
Text File  |  1995-03-15  |  20KB  |  434 lines
  1. -------------------------------------------------------------------------
  2. Protracker V1.1 Release B - (C) 1991 Amiga Freelancers         12/01-1991
  3. -------------------------------------------------------------------------
  4.  
  5. Protracker is a Public Domain program, and may may be copied freely and
  6. included in any PD library. You may not charge anything for the program
  7. other than the cost of the disk and the PD-service.
  8.  
  9. This disk should contain the following files:
  10.  
  11.   PT1.1                  -  The main program (not packed, do it yourself).
  12.   PT1.1.info             -  The Icon for Protracker, by Quantarc.
  13.   PROP                   -  Protracker module player.
  14.   TempoCalc.txt          -  How to calculate tempo etc.
  15.   PT-Play.s              -  Playroutine for the Seka or DevPac assemblers.
  16.   PT-CIAPlay.s           -  Playroutine for CIA timing.
  17.   PTFileFormat.txt       -  Description of the file format.
  18.   PTEffects.txt          -  Quick help on all effect commands.
  19.   PT.help                -  Online helpfile for PT1.1B (press the Help key).
  20.   PT.help.txt            -  Read-/Printable version of the help file.
  21.   PT.help.txt.info       -  Icon for the PT.help.txt file, by Quantarc.
  22.   PT.config-00           -  Default configuration file.
  23.   PT.ReadMe!             -  ****--> This file <--**** 
  24.   PT.ReadMe!.info        -  Icon for the ReadMe! file, by Quantarc.
  25.  
  26. If you pack Protracker, please use a packer with real hunk-handling.
  27. Powerpacker or Imploder will do just fine. No absolute-address crap!!!
  28.  
  29. If you have a version of PT1.1A where the Slow Mode toggle is missing,
  30. get rid of it. It's an Unofficial version spread by some stupid people
  31. at the Theatre/Network conference! (Make sure that your programs are
  32. all right before putting them on those damned compact disks!)
  33.  
  34.  
  35. Some info..
  36. -----------
  37.  
  38. This disk contains all the necessary files to run Shell, CLI, and all the
  39. most used CLI-Commands. It is possible to print songs, but we'we only
  40. included the Generic printerdriver, so you'll have to install your own.
  41. Remember to set the new printerdriver with Preferences. If you make your
  42. own workdisk, remember to copy the commands "Run" and "EndCLI".
  43.  
  44. If you are going to make make a compact-disk containing Protracker, please 
  45. include PT.help!!! THIS IS VERY IMPORTANT!!!
  46.  
  47.              DO NOT ATTEMPT TO EDIT THE HELP-FILE!!!
  48.  
  49. The first 1024 bytes are a text-offset index for Protracker, so keep off. 
  50.  
  51. For more info, press the HELP key when you have started Protracker.
  52.  
  53. It IS possible to load old PT1.0 configuration files with PT1.1, but some
  54. of the new setup stuff will be set to zero. Remember to set tempo, DMAwait,
  55. tuning tone and the new toggles to correct values when loading an old
  56. config/file! Otherwise you'll experience lost notes, crashes etc...
  57.  
  58.  
  59. --- Protracker history ---
  60.  
  61. First Version 1.0 (A) - Full of bugs...
  62.  
  63. Bugs corrected in V1.0 Release B:
  64. ---------------------------------
  65.  - PatternLoop (It always jumped to the start of the pattern, not the loop)
  66.  - Zap had put FineTune AND Glissando-Control in the same command! (E3)
  67.  - Fade Up / Down caused shit and even a few gurus!
  68.  - Delete Pos inserted pattern 77 (!) at position 127 in the song, causing
  69.    it to be longer than 80k!
  70.  - Filter All Samples was slow as hell because it tried to filter non-
  71.    existant samples.
  72.  - If you selected sample 0 from the keypad, it always played the last
  73.    sample played as sample 0!
  74.  - A590 harddisk owners couldn't use the keyboard because of the way Mahoney
  75.    & Kaktus set up the keyboard interrupt (we used their NT1.1 routine).
  76.  - Entering the help screen when in the midi screen fucked up the display.
  77.  - Escaping from Mix exited from the whole edit op.!
  78.  - CutBeg no longer fucks up the Sample length and Pos.
  79.  - The help file was FULL of bugs / misspellings.
  80.  
  81. Bugs corrected in V1.0 Release C:
  82. ---------------------------------
  83.  - Error in Finetune-table2 (note B-2)
  84.  - Abort Load sometimes caused a guru!
  85.  - Toneportamento (cmd 3) didn't work correctly with finetune.
  86.  - PLST screen was one pixel off.
  87.  
  88.  MIDI screen was removed.
  89.  
  90.  
  91. Changes and improvements from Protracker V1.0C to V1.1A:
  92. --------------------------------------------------------
  93.  
  94. General:
  95.   - Protracker will now run if you have Kickstart 2.0 installed!
  96.     (A500, A1000, A2000, A3000 etc...)
  97.   - Protracker will also "Auto runback" when you start from CLI!
  98.     There's no need to use the 'run' command.
  99.   - Keyboard and mouse input is provided by an InputHandler with prior-
  100.     ity 52. The handler will grab all RAWKEY and RAWMOUSE events from
  101.     the input.device before they reach intuition. PT will no longer
  102.     interfere with windows and gadgets on the intuition screen behind.
  103.   - Keyboard buffer. Wow!!! Now you can play really fast, and PT won't
  104.     miss a single key (...well, not as many as it used to before...).
  105.   - The vertical blank interrupt no longer patches the vector itself, but
  106.     uses the AddIntServer function.
  107.   - The playroutine creates it's own CIA or VBLANK interrupt, and it will
  108.     not be removed if a song is playing when you go to CLI/Workbench.
  109.   - Text input routine changed a little. Use mouse to set pos and to exit.
  110.   - Improved "Out of memory" handling (hopefully no more gurus...).
  111.   - Only the first 2 bytes of a sample will be zeroed (were the first 4).
  112.   - Lots of new keyboard commands/shortcuts using the Alt key.
  113.   - Vibrato depth changed to be compatible with NT2.0. Double all your
  114.     depth numbers if you load old protracker songs.
  115.   - Funk Repeat changed to Invert Loop (may trash your samples though).
  116.   - Play samples from the keypad (dot mode) when pressing backslash.
  117.  
  118. Main Screen:
  119.   - MIDI screen has been removed. Changed to sampler instead. MIDI input
  120.     is still there, but there's no MIDI output. Sorry...
  121.   - Quadrascope. Four channel oscilloscope that displays the samples
  122.     in real-time, even when playing from keyboard. The good old spectrum
  123.     analyzer is still there, just click on the scope to toggle.
  124.   - Tempo gadget. Default is 125 BPM (normal vblank speed), but that can be
  125.     changed if you select CIA timing on Setup2. Range is 32-255 BPM, and
  126.     can also be changed with the 'F' effect command (speed/tempo).
  127.   - Repeat and replen will be updated in the samples when you change them.
  128.     You no longer have to press a key to hear the new loop.
  129.   - Protracker should now be able to show up to 10/16 megs of freemem.
  130.   - Error messages when PLST or Config not found.
  131.   - Click to enter position, pattern and length with the keyboard.
  132.  
  133. Disk Op.:
  134.   - Choose RAW or IFF when saving samples.
  135.   - Samples can be saved with IFF-loops.
  136.   - Change path without reading directory.
  137.   - All 30 characters in filename/directory stored (was 24).
  138.   - Shows directories, just click to add directory to path.
  139.   - Parent directory gadget.
  140.   - One preset and several default paths for modules/songs/samples.
  141.   - PT will now read an "unlimited" number of directory entries (was 200).
  142.  
  143. Setup:
  144.   - The only thing that's happened here is a small gadget labeled "2".
  145.     Pressing it will put you in...
  146.  
  147. Setup2:
  148.   - 8 new on/off toggles.
  149.     Override: Load/save sample from samplepath even if there's a path
  150.       in the samplename. ST-37:bigbadbass with override will be loaded
  151.       from DF0: (or whatever) instead of ST-37:. You may want to put
  152.       all your samples in one big directory on your harddisk...
  153.     NoSamples: Will load a song without asking for the samples.
  154.     BlankZero: This will show the samplenumbers in the pattern in the
  155.       same way as Noisetracker 1.2 (Zeros are blanked out).
  156.     Show Dirs: If on, directories will be shown in Disk Op.
  157.     Show Publ: If on, PT will show all free Public memory, otherwise
  158.       just free Chip memory.
  159.     CutToBuff: If on, the part of the sample cut away in the sample
  160.       editor will be saved in the copybuffer.
  161.     Load Loop: Will load loops from an IFF file when loading a sample,
  162.       or adding a path in the sampleeditor.
  163.     Slow Mode: Use this toggle if you have a 25 Mhz A3000 where every-
  164.       thing is faster. Turning it on might help.
  165.   - Set Default paths.
  166.   - You can set the maximum number of presets (used to be 2500).
  167.   - DMA wait. Use this on 25MHz Amigas (normally 300, use 900 on A3000).
  168.   - Set tuning tone (note and volume).
  169.   - Select CIA or VBlank timing.
  170.   - Set default CIA tempo.
  171.   - Spectrum Analyzer/VU-meter copper color editor!
  172.  
  173. Preset Editor:
  174.   - Use Preset removed, inserted Delete Disk instead.
  175.   - You can now save Finetune instead of Volume in the PLST. 
  176.   - ST-disk number changed to hex (ST-00 --> ST-FF)!
  177.   - Adding samples with IFF-loops to the presetlist is possible.
  178.   - Proper PLST allocation. Protracker will no longer allocate
  179.     any memory if there's no PLST.
  180.  
  181. PLST:
  182.   - ST-disk number changed to HEX. This means you can have
  183.     up to $FF, or 255 ST-disks (used to be 99).
  184.  
  185. Sampler/Sample Editor:
  186.   - Sample Graphing like Audiomaster. With Show Range, Show All,
  187.     Zoom Out, Range All, etc...
  188.   - Play either Waveform, Display or Range.
  189.   - Repeat points are shown, and can be dragged around.
  190.   - Loop on/off toggle.
  191.   - A line shows current position when playing back a sample.
  192.   - A sampler just like on NT2.0.
  193.   - Resample function w/tuning tone.
  194.   - Cut, Copy and Paste functions.
  195.   - Cursor to beginning/end.
  196.   - Swap current sample with copybuffer.
  197.  
  198. Edit Op.:
  199.   1 - Transpose All bug removed.
  200.   2 - Move changed to Copy (use this to copy samples too).
  201.   3 - Upsample changed a tiny bit (allocation).
  202.   3 - Most functions will now work with marked ranges.
  203.  
  204. Bugfixes and changes from PT1.1A to PT1.1B:
  205. -------------------------------------------
  206.  
  207. - Load gadget no longer hangs the program when trying to load a file that
  208.   doesn't exist.
  209. - Better filehandling with error messages.
  210. - Repeat and replen check installed (Rel. A hanged when replen accidentally
  211.   got the value zero).
  212. - Repeat and replen were swapped when loading an IFF sample.
  213. - Only RepLen values in IFF samples were added in the preset-editor.
  214. - Tune memory wasn't always updated when editing samples.
  215. - Swap Buffer debugged.
  216. - The arpeggio sounded weird because the pitch wasn't set back at the
  217.   right time.
  218. - Shift speeds up the scrolling in the PLST and preset-editor.
  219.  
  220.  
  221. Known bugs, errors, stupid things and other crap:
  222. -------------------------------------------------
  223.  
  224. - If you load a song or module that's not a proper ST-module,
  225.   Protracker may trash the upper left of the screen and/or crash.
  226.   This screen-trashing may also happen other times. Don't ask us why
  227.   or when. There is really no proper way to check if a file is a module
  228.   or song. We check for "M.K." at offset 1080, and if isn't found,
  229.   Protracker asks if you want to load it with 31 samples, since it may
  230.   be a Startrekker module. If you answer no, PT assumes it's an old
  231.   15 samples song/module.
  232.  
  233. - There's something wrong with the spectrum analyzer. Sometimes the
  234.   analyzer is cleared without the volume being set to zero. This creates
  235.   "holes" which are pretty annoying to look at, but they disappear if you
  236.   let the analyzer fall down to zero (stop the song).
  237.  
  238. - If you format a disk with Protracker, it's possible to save files to the
  239.   disk, but if you try to load the files you just saved, nothing comes up
  240.   in the disk op. screen.  If could be that the Amiga has some problems
  241.   validating the disk, but there are no such messages. We'll have a look
  242.   at the Format routine.
  243.  
  244. - We're not sure that the MIDI input routines work at all...
  245.  
  246. - You cannot have two presets with the same name on different ST-disks.
  247.  
  248. If you send us bug reports, please describe the bugs properly, so that we
  249. can figure them out without too much trouble. State how, when and where
  250. the bug appeared, if it's there all the time, or just happened once.
  251. If you can tell us how to duplicate what you did to get the bug, it
  252. would be great. THEN we can try to eliminate it, ok?
  253.  
  254.  
  255.  
  256. And now we will try to explain some common misunderstandings:
  257. --------------------------------------------------------------
  258.  
  259. > Look at this man! This new tracker's got a really mind-blowing equalizer!
  260.  
  261.   No, it doesn't. In fact we have never seen a single Amiga program with an
  262.   equalizer. But VU-meters (Volume Unit that is) and Spectrum Analyzers
  263.   are featured on most demos and soundtrackers. An equalizer is just like
  264.   an tone control with cut/boost controls for each frequency range. Just
  265.   take a look at your stereo, and maybe you'll find some sliders marked 125,
  266.   250, 500, 1k, 2k, 4k etc. That is an Graphic Equalizer. There are also
  267.   Parametric Equalizers where you can change the center frequency and Q-
  268.   factor (bandwidth) of each band, but they are usually found on mixer
  269.   consoles and other equipment. Spectrum Analyzers shows the relative volume
  270.   of each frequency band, but of course the Amiga cannot analyze the spectrum
  271.   of the samples in real time, so it will will just show which notes you
  272.   play. VU-meters are even simpler, they show the volume of the sound.
  273.   But again, the Amiga cannot (it could, but it would take up a lot of time)
  274.   show the real volume of the samples, so the VU-meter just pops up to
  275.   the volume you have set for a sample, and falls back to zero.
  276.   Not even the scopes will show the sample just as it is. They show 40 (or
  277.   was it 48?) bytes of the sound, and will just "scroll" through the sample
  278.   as it plays back.
  279.  
  280.   Besides, if you're so keen on calling them Equalizers, can't you at
  281.   least spell it right....Equilisers.....ARRGGHH!
  282.  
  283. > I have got all the ST sample disks. From ST-01 to ST-99.
  284.  
  285.   No you haven't. There are no standard set of 99 sample disks. You just
  286.   name a disk ST-something, and copy all your samples to it. Wonga! You've
  287.   got a new sample disk! If you really have 99 disks, we don't think it would
  288.   hurt to throw away some of your least used samples. Who needs disks with
  289.   aliased, untuned samples with 2k dead air in the beginning of each of them?
  290.   No need to fill your harddisk with them either. Please tune your samples to
  291.   C-2 or C-3 (use the resampling function), and cut away that ugly silence
  292.   in the beginning...
  293.   (BTW: Aliasing is something you get when recording a sample, NOT when
  294.   you play it back.)
  295.  
  296. > I really liked your PlayList editor!
  297.  
  298.   No you didn't. PLST is an abbreviation for PresetList!!!
  299.  
  300.  
  301.  
  302. Things you want, that we don't want:
  303. ------------------------------------
  304.  
  305. > 8 Channels, like Startrekker and Oktalyzer.
  306.  
  307. Nope! The Amiga has only got four real audiochannels, so in order to play
  308. eight channel music the CPU has to read the samples itself, and feed them
  309. to the four channels byte by byte. This will use most the available time,
  310. and you'll not be able to do anything else at the same time. Normally
  311. sample playback is done by DMA (Direct Memory Access), were the sampledata
  312. if fetched automatically from memory without the processor intervening.
  313.  
  314.  
  315. Things we want, but don't know how to do:
  316. -----------------------------------------
  317.  
  318. - Reverb...
  319.  
  320. Hmmm... I know what it is, and I even have an Alesis Midiverb II Digital
  321. Effects Processor with reverb and other nice effects. But how do you create
  322. reverb on an Amiga? Well, first there is Direct Sound; that's just the
  323. original sample. Then there's Early Reflections; which is the first part of
  324. the reflected sound. It's just a few short delays with perhaps some lowpass
  325. filtering, and I have already solved that part of the problem. With long
  326. delays it sounds like echos, but shorter delays makes it sound more muddy,
  327. and in stereo, it spreads the sound image.
  328. But then there's reverb, which is sound that has reflected more than once.
  329. It could probably be implemented as a series of delays with feedback, plus
  330. some damping filters here and there, but the results so far has been dis-
  331. appointing. It sounds like resonant echos, or it overloads and clips the
  332. sample. Grrrr!!!
  333. So if you have a reverb algorithm or a book that explains how to do such
  334. things, please let me know. We will include it in the next version of PT.
  335. Some info on digital filters (how to calculate those damned coefficients)
  336. would be nice too (FIR & IIR filters).
  337.  
  338.  
  339. Things to come in newer versions:
  340. ---------------------------------
  341.  
  342. - Synthetic sounds
  343.  
  344.   Yes, yes, yes!!! But how do you want it implemented?
  345.   It would be nice if you could draw some examples and send them to us.
  346.   Please don't send us a letter that just says: "I want it to be just like
  347.   on <name of musicprogram>". Programs using synthetic sounds has usually
  348.   envelopes, modulation, wavetables and other stuff for each instrument,
  349.   while the tracker way to it is to set all that using effect commands.
  350.   How should we combine the good old samples with the new synthetic sounds?
  351.   We still haven't got all music programs for the Amiga, so if you have
  352.   seen something great on any program that you want to have in PT, please
  353.   send a disk with the program. We have most of the trackers, but not all
  354.   the synthetic sound programs.
  355.  
  356. - MIDI
  357.  
  358.   Look, boys (and girls). Protracker is not supposed to be a MIDI sequencer.
  359.   It's a music program that you use to create music for demos, games, music
  360.   disks or just to listen to on your Amiga. MIDI sequencers has got a much
  361.   higher timing resolution and lots of tracks, while Protracker has 16ths
  362.   and only four tracks. Some of you want to hear your music played on your
  363.   synthesizers too, but the tracker was not really designed to do that.
  364.   The MIDI screen on PT1.0A&B looked so promising, but we didn't have time
  365.   to finish it. The MIDI functions will have to be coded some day, but we
  366.   just don't know when that will be...
  367.  
  368.   In the mean time you can use the terrible NoiseTracker 2.0 (Oh no!).
  369.  
  370.   PT1.1B: MIDI functions are not functioning at all!!!!!
  371.   If you really need MIDI, you'll have to wait for the new version.
  372.  
  373.  
  374. Other projects we're working on, or are going to be working on:
  375. ---------------------------------------------------------------
  376.  
  377.   ABBS          - A conversion of MBBS for Amiga. (Lattice C)
  378.   RPG Adventure - Will this ever be finished? (C & Assembler)
  379.   ProSound (?)  - Sample Creator program. Better than Synthia? (Assembler)
  380.   (no name yet) - Elite like game with vector graphics etc... (Assembler)
  381.  
  382. We really don't know when PT1.2 will be released. Wait and see...
  383.  
  384. If you want us to send you the new version of Protracker, send two
  385. disks (nice if there's something on the disks), and you will get one
  386. of them back with PT. We keep the other disk (sending disks all around
  387. the world costs a lot of money). Or... you could send us some money
  388. instead (helst norske kroner).
  389.  
  390.  
  391. Amiga Freelancers are:
  392.  
  393.   Lars Hamre    ==> ZAP
  394.   Anders Hamre  ==> The Mad Martian
  395.   Rune Johnsrud ==> Quantarc
  396.   Sven Vahsen   ==> The Moose
  397.  
  398.  
  399. If you want to contact us for any reason (please do) write to:
  400.  
  401.   Lars & Anders Hamre / Amiga Freelancers
  402.   Bekkeliveien 10
  403.   N-2010 STRØMMEN
  404.   Norway
  405.  
  406.   Phone: (06) 817466
  407.  
  408.  
  409. Or to:
  410.  
  411.   Rune Johnsrud / Amiga Freelancers
  412.   Skogveien 16
  413.   N-2010 STRØMMEN
  414.   Norway
  415.  
  416.   Phone: (06) 813850
  417.  
  418.  
  419.   You can also contact us at the Crusaders BBS, by writing a message to:
  420.   ANDERS HAMRE, LARS HAMRE, RUNE JOHNSRUD or THE MOOSE.
  421.  
  422.   Phone Norway: +47-6-810864
  423.              or +47-6-810881
  424.  
  425. +--------------------------------------------------------------------------+
  426. | Do YOU want to become a member of Amiga Freelancers? We need coders that |
  427. | can/will/want to do other stuff that just demos. You could join us, and  |
  428. | help us make Protracker an even better program! We need musicians (good  |
  429. | or bad [no, not bad]), graphics artists or anyone else that would like to|
  430. | join us. We're just four really lazy people at the moment...             |
  431. +--------------------------------------------------------------------------+
  432.  
  433. /* End of File */
  434.